home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
dskut
/
gd_v11.zip
/
JUDGE.DOC
< prev
Wrap
Text File
|
1992-12-24
|
21KB
|
795 lines
.PL
JUDGE Language Manual 12/24/92
JUDGE Language Manual
(C) Copyright 1992, Jack Hwang
Version 1.1
1
JUDGE Language Manual 12/24/92
T a b l e o f C o n t e n t
---------------------------------
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . 3
Language Description . . . . . . . . . . . . . . . . . . . . . 4
Basic Style. . . . . . . . . . . . . . . . . . . . . . . . . . 4
Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Keywords . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Names. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Description. . . . . . . . . . . . . . . . . . . . . . . . . . 5
MODULE definition. . . . . . . . . . . . . . . . . . . . . . . 6
Record . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
ABSOLUTE record. . . . . . . . . . . . . . . . . . . . . . . . 7
RELATIVE record. . . . . . . . . . . . . . . . . . . . . . . . 8
FIELD definition . . . . . . . . . . . . . . . . . . . . . . . 10
DATA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
ENTRY. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Comment. . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2
JUDGE Language Manual 12/24/92
Introduction
------------
JUDGE is a definition language designed to work with GameDirector
to provide a universal data editing capability. JUDGE defines
the name, the location and the size of a data in a data file, as
well as how will this data be displayed on the screen for
editing. GameDirector then can read the definitions, get data
from a file, and display forms which consist of these data for
editing.
JUDGE is designed to be structured and hierarchical but yet
simple. Different levels in the hierarchy represent not only the
hierarchical meaning of data, but also the operation logic used
in form entries. Also, the syntax is very simple and straight
forward. No prior knowledge about any programming languages is
needed.
Other than its simplicity, JUDGE also provides flexibility.
Since the definitions are in ASCII format, it is very easy for
users to add, modify, and delete definitions. Users can
gradually add in their new definitions and entries for a data
file. The users can also customize the files for their own needs.
The other good features is that it can handle a huge amount of
data items. Each data item is a field in a record. And a record
is showed as a form with up to 8 pages. Since there is no
limitation on the number of fields a record can have except for
that they should be able to show up on the pages, a record (or a
form) can hold a lot of fields. Better than that, since there is
no limitation on the number of records, a JUDGE file should be
able to hold as many definitions as the system memory allowed.
JUDGE can also handle the situation that several set of data uses
the same definition in a record --- where the record has to be
"relative" one. The example is the data of each member in a
role-playing game. For all the rest of data, it would simply
uses absolute records.
3
JUDGE Language Manual 12/24/92
Language Description
--------------------
JUDGE is simple but structural. It uses a hierarchical structure
to organize data. Data are defined as fields in JUDGE. And
fields are grouped together to be a record. Then records are
grouped as a module. A module is the equal of a definition file.
For each of the definitions and definition groups (fields,
records, and module), programmers should provide a name and some
descriptions. Other than for identification, names are used as a
tag ID as well as a label in forms. The descriptions can be any
information which would help the GameDirector users to edit data.
A typical description would be that about the value range the
users can enter into the field.
Basic Style
-----------
For people who are familiar with programming languages, they may
find that the syntax of JUDGE is similar to structure definitions
in may programming languages. That is true. The basic style in
JUDGE would be something like:
module "module name" {
desc "description about module"
absolute "A record" {
desc "description about record"
field "Gold" {
desc "description about Gold"
data ....
entry .....
}
... something
}
... something
relative "R record" {
desc "description about record"
recloc ...
field "Name" {
...
}
filed "Race" {
...
}
}
... something
}
4
JUDGE Language Manual 12/24/92
Syntax
------
The following is the details about JUDGE.
Keywords
--------
Keywords can be either all lower case or upper case characters,
but not the mixture of both. That is, the keywords for defining
a module can be either "MODULE" or "module", but not "Module".
The following are keywords essential to JUDGE:
MODULE, ABSOLUTE, RELATIVE, FIELD, DESC, RECLOC, DATA, ENTRY.
Names
-----
The names of module, records, and fields are all quoted strings.
It should not be longer than 40 characters. The suggest length
is under 20.
Description
-----------
Descriptions are double-quoted strings which will be displayed in
GameDirector if the users want some help on the data objects. It
is allowed to have multiple lines of descriptions for a
definition. However, there is a restriction when GameDirector
displays them to the screen. Thus the effective number of lines
should be under 16. The length of the string should not be
longer than 70 characters long.
Syntax:
DESC string
Example:
desc "This is a description line for module."
desc "This is a line for record."
5
JUDGE Language Manual 12/24/92
MODULE definition
-----------------
Module is just a abstract container for records though it still
h